Skip to content

[dashboards] Canonical landing page for openbrain.fyi#258

Merged
justfinethanku merged 3 commits into
NateBJones-Projects:mainfrom
snapsynapse:contrib/snapsynapse/canonical-landing-page
Jun 5, 2026
Merged

[dashboards] Canonical landing page for openbrain.fyi#258
justfinethanku merged 3 commits into
NateBJones-Projects:mainfrom
snapsynapse:contrib/snapsynapse/canonical-landing-page

Conversation

@snapsynapse

@snapsynapse snapsynapse commented May 3, 2026

Copy link
Copy Markdown
Contributor

Contribution Type

  • Recipe (/recipes)
  • Schema (/schemas)
  • Dashboard (/dashboards)
  • Integration (/integrations)
  • Skill (/skills)
  • Repo improvement (docs, CI, templates)

What does this do?

Adds dashboards/ob1-canonical-landing/ — a fully self-contained static landing page intended to live at https://openbrain.fyi via GitHub Pages. No build step, no dependencies, no framework. The PR ships the page plus all crawler companion files (sitemap.xml, robots.txt, llms.txt, site.webmanifest, 404.html), bundled brand assets (favicons, hero banner, OG image), a step-by-step README.md deploy guide, and a MAINTENANCE.md for ongoing edits.

The openbrain.fyi domain is registered to me and I'll transfer the registration to the project at your convenience after merge — no action required on your part to ship the page; DNS already points at the org's Pages.

Requirements

  • Maintainer access to the repo (to add the deploy workflow YAML and enable Pages)
  • No Open Brain instance required to deploy or serve this page — it's pure static HTML

Page features:

  • Full SEO meta + OG/Twitter cards + JSON-LD (TechArticle + DefinedTerm)
  • WCAG 2.1 AA (single h1, skip link, prefers-reduced-motion, contrast-checked palette)
  • Sticky-nav glass effect, brand-blue hero gradient, OB1 orange/navy palette extracted from the existing logo
  • Page weight: 44KB HTML + 108KB images total
  • Bylined to Nate B. Jones (project author) — contribution authorship lives in metadata.json

Checklist

  • I've read CONTRIBUTING.md
  • My contribution has a README.md with prerequisites, step-by-step instructions, and expected outcome (plus MAINTENANCE.md for post-merge upkeep)
  • My metadata.json has all required fields
  • If my contribution depends on a skill or primitive, I declared it in metadata.json and linked it in the README — N/A; this is a self-contained static page with no skill/primitive dependency
  • I tested this on my own Open Brain instance — tested locally (rendered + WCAG-AA verified + JSON-LD parsed); no Open Brain instance needed for this contribution
  • No credentials, API keys, or secrets are included

@github-actions github-actions Bot added dashboard Contribution: frontend template extension Contribution: curated learning path build recipe Contribution: step-by-step recipe labels May 3, 2026
snapsynapse and others added 2 commits May 2, 2026 23:02
@snapsynapse @claude
[dashboards] Canonical landing page for openbrain.fyi
0609b47 
Adds dashboards/ob1-canonical-landing/, a self-contained static landing
page targeting https://openbrain.fyi via GitHub Pages. No build step,
no dependencies.

Includes:
- index.html with full SEO meta, OG/Twitter cards, JSON-LD (TechArticle
  + DefinedTerm), skip-link, sticky-nav glass effect, hero gradient,
  prefers-reduced-motion handling
- 404.html (branded, noindex) with brand-blue gradient
- Brand assets generated via ImageMagick: favicon-32, apple-touch-icon
  (180), square logo (512), wide hero banner (1200), social OG (1200x630
  composited on brand-navy)
- Crawler companions: sitemap.xml, robots.txt, llms.txt, site.webmanifest
- CNAME bound to openbrain.fyi
- README.md with step-by-step deploy guide (workflow YAML, DNS table,
  Pages enable + custom domain + HTTPS, optional org-level domain
  verification, domain donation handover step)
- MAINTENANCE.md covering edit-and-deploy loop, copy/video/logo updates,
  pre-deploy validation (JSON-LD, a11y, link health, size budget),
  post-deploy verification, decommissioning

WCAG 2.1 AA, single h1, validated JSON-LD, gate-schema-compliant
metadata.json. Page weight: 44KB HTML + 108KB images.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@snapsynapse @claude
[dashboards] Trim donation step from landing-page README
80907cc 
The README is the maintainer-facing deploy guide; the domain donation
handover is a side-channel between contributor and maintainer, not a
deploy step. Replaces the now-removed donation step with a "Verify DNS"
step that documents the existing record table for reference.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@snapsynapse snapsynapse force-pushed the contrib/snapsynapse/canonical-landing-page branch from 03fab5a to 80907cc Compare May 3, 2026 05:02
@alanshurafa alanshurafa added area: dashboard Review area: dashboard/frontend review: ready-for-maintainer Community reviewer recommends maintainer review alan-reviewed Reviewed by Alan Shurafa in Community Reviewer role labels May 20, 2026
@alanshurafa

alanshurafa commented May 20, 2026

Copy link
Copy Markdown
Collaborator

Thanks for the contribution. This is a well-crafted static landing page — fully self-contained, no build step, and it ships the full set of crawler companion files (sitemap.xml, robots.txt, llms.txt, site.webmanifest) plus icons, which is thorough.

This one is a maintainer decision rather than a code-review call. The PR includes a CNAME file for openbrain.fyi and is intended as the project's canonical public landing page — that touches domain ownership, GitHub Pages configuration, and public brand positioning, all of which sit with the maintainer. Needs product decision: whether OB1 wants a canonical landing page at that domain and is ready to publish it. Routing to the maintainer.

— Alan (community reviewer; non-binding)

justfinethanku
justfinethanku approved these changes Jun 5, 2026
View reviewed changes

@justfinethanku justfinethanku left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed in the maintainer merge lane. Static landing bundle rebases cleanly, local asset references resolve, metadata is valid, and the contribution credit convention is now present.

@justfinethanku justfinethanku merged commit fa405fd into NateBJones-Projects:main Jun 5, 2026
2 checks passed
@snapsynapse

snapsynapse commented Jun 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Thanks for accepting! Just realized there is one more first-time setup step that might be needed.

  1. go to https://github.com/NateBJones-Projects/OB1/settings/pages
  2. under brand, select main
  3. under folder, select dashboards, then save
  4. in Custom Domain, add openbrain.fyi and save again
  5. it may take up to 20min to resolve DNS, then check "Enforce https" and let it resolve that

Now it should work!

Here are the current settings at the registrar:

Type Host Value TTL  
A Record @ 185.199.108.153 Automatic Remove
A Record @ 185.199.111.153 Automatic Remove
A Record @ 185.199.109.153 Automatic Remove
A Record @ 185.199.110.153 Automatic Remove
CNAME Record www natebjones-projects.github.io. Automatic  

Please confirm who the new owner should be, and I'm happy transfer domain ownership at any time in the next 10 months.

@snapsynapse

snapsynapse commented Jun 5, 2026

Copy link
Copy Markdown
Contributor Author

Sorry for the back-and-forth. I didn't realize Github Pages branch-deploy can't serve dashboards/, only / or /docs. So it needs an Actions workflow instead. I'll open a follow-up PR with the workflow file (.github/workflows/deploy-pages.yml). Once merged, three switches on your side:

Settings → Actions → General → Workflow permissions → Read and write permissions → Save
Settings → Pages → Source → GitHub Actions (dropdown, not "Deploy from a branch")
Settings → Pages → Custom domain → openbrain.fyi → Save (DNS already correct, green check should appear)
Then Actions tab → "Deploy landing page" → Run workflow on main. When green, site live at https://openbrain.fyi/. After 5–30 min tick Enforce HTTPS.

Apologies! Didn't know this would be a different pattern than all my other repos.

@snapsynapse snapsynapse mentioned this pull request Jun 5, 2026
Open
4 tasks
@snapsynapse

snapsynapse commented Jun 5, 2026

Copy link
Copy Markdown
Contributor Author

Okay, followup PR is at #342

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@justfinethanku justfinethanku justfinethanku approved these changes

Assignees

No one assigned

Labels

alan-reviewed Reviewed by Alan Shurafa in Community Reviewer role area: dashboard Review area: dashboard/frontend dashboard Contribution: frontend template extension Contribution: curated learning path build recipe Contribution: step-by-step recipe review: ready-for-maintainer Community reviewer recommends maintainer review

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@snapsynapse @alanshurafa @justfinethanku